home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / wildcat / wlist160.zip / WILDLIST.DOC < prev    next >
Text File  |  1993-01-24  |  18KB  |  433 lines
  1.  
  2.  
  3.  
  4.                        WILDLIST v1.60   Jan. 24, 1993
  5.  
  6.                 Filelist Utility for WildCat! BBS Operators
  7.  
  8.  
  9.                               Richard Skinner
  10.                  Fido 1:117/112  or 409-260-1883 (USR HST)
  11.                  Fido 1:117/132  or 409-846-0754 (V32.b V42.b)
  12.  
  13.  
  14. Important Note !
  15. ~~~~~~~~~~~~~~~~
  16. Changes have been made to the Configuration Files at Line 17 & 18.
  17. Refer to the WhatsNew.160 Doc Included.
  18. Also look at the lower portion of these docs for details.
  19.  
  20.  
  21. Overview:
  22. ~~~~~~~~ 
  23. WildList! is a filelist generation utility for use with the WildCat! BBS
  24. software, version 3.0 or higher.
  25.  
  26. WildList! is extremely fast and customizable.  Beta testers have reported
  27. processing in excess of 200 files per second! (4 meg Cache 486-50)
  28.  
  29. Unlike some other filelist utilities, there is no maximum number of files
  30. which WildList! can process.  Ok, there is a limit of 2 billion files.
  31.  
  32. WildList! is DESQview-aware.
  33.  
  34. WildList! Supports Novell, and Share type networks.
  35.  
  36. Wildlist! is fully multinode compatible.
  37.  
  38. A WildCat! BBS Operator may customize WildList! in many ways, resulting in a
  39. filelist that is unique to their BBS.  The "secret" to this customization
  40. lies in the WildList! configuration file which is discussed later in these
  41. DOCs.
  42.  
  43.  
  44. Important !!!!
  45. ~~~~~~~~~~~~~~~
  46. Wildlist comes with a demo key called wildlist.key. If this key file is
  47. expired when you get this archive, then download a new key file from one
  48. of the support sites listed at the end of this file.
  49.  
  50.  
  51.  
  52.  
  53. Command Line Parameters:
  54. ~~~~~~~~~~~~~~~~~~~~~~~ 
  55.       a. Files Listing:
  56.  
  57.             From the command line,
  58.  
  59.                   WILDLIST WILDLIST.CFG
  60.  
  61.             will generate the filelist and/or bulletin file, customized in
  62.             accordance with the configuration instructions within the
  63.             WILDLIST.CFG file.  A configuration file MUST be specified, but any
  64.             number of configuration files may be used if the WildCat! BBS
  65.             Operator desires.
  66.  
  67.       b. New Files Listing:
  68.  
  69.             From the command line,
  70.  
  71.                   WILDLIST WILDLIST.CFG 30
  72.  
  73.             will generate a filelist and/or a bulletin file of all new files
  74.             uploaded in the last 30 days.  Again, a configuration file MUST be
  75.             specified, but any number of configuration files may be used if the
  76.             WildCat! BBS Operator desires.
  77.  
  78.       c.  Global File Listing:
  79.  
  80.             From the command line,
  81.  
  82.                   WILDLIST WILDLIST.CFG GLOBAL
  83.  
  84.             will generate a alphabetized file list of all the files you have
  85.             specified on Line 7. Its best to use the Exclude command on this
  86.             type set up since the entire file database is scanned.
  87.  
  88.       d.  Adding a File:
  89.  
  90.             Normally, WildList! will only update an existing file in the
  91.             WildCat! database with the fresh file stats if the Freshen option
  92.             is turned on by Line 9.
  93.  
  94.             Sometimes, people create a new list that is not in the database
  95.             already, and the sysop must manually add the file and move it. 
  96.             WildList! has a new command line parameter for this:
  97.  
  98.                   WILDLIST WILDLIST.CFG ADD 28
  99.  
  100.             If a command line like the above is used, WildList! will create the
  101.             database entry with the filename and path specified in your config
  102.             file then freshens it.
  103.  
  104.             The Add switch must always be the 2rd parameter and the Area which
  105.             the file should put in will always be the 3rd parameter.  With this
  106.             option, you still need to enter the file description as wildlist
  107.             will only create the Filename, Size, Date, and Default flags in the
  108.             database.
  109.  
  110.             Remember, if your path to this file is different from the area that
  111.             you specified, the actual filepath will be inserted into the
  112.             database, making the file still available.
  113.  
  114.  
  115. WildList! Configuration File:
  116. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 
  117. C:\WC30                       Line 1:     Path to the widlCat! BBS files
  118.  
  119.                               NOTE:       Lines 2 & 3 can use the WC area
  120.                                           number now.  Use the Area keyword
  121.                                           space, the Wc Area # space, File
  122.                                           List Name.
  123.  
  124.                                           AREA 44 FILES.ZIP
  125.  
  126.                                           Or you may do it as shown below.
  127.  
  128.  
  129. C:\WC30\117-000.LST           Line 2:     Full pathname for the filelist
  130.                                           output file.  This is a straght pure
  131.                                           ASCII file created before
  132.                                           compression.
  133.  
  134. C:\WC30\AREA1\ALLFILES.ZIP    Line 3:     Full pathname for the compressed
  135.                                           filelist.  If not using the Freshen
  136.                                           option, this can be any name.
  137.  
  138.                               NOTE: If using the Freshen option, then this
  139.                               path should be the same as the one in MAKEWILD
  140.                               for the area were your file list will reside.
  141.  
  142.                               Example: From MAKEWILD, File Area Definition,
  143.                               let's say your downloadable filelist is in
  144.                               Area #1, C:\WC30\AREA1, and the name of the
  145.                               compressed filelist is ALLFILES.ZIP.  On line
  146.                               3, then, the full pathanme to this file would
  147.                               be: C:\WC30\AREA1\ALLFILES.ZIP
  148.  
  149. ARJ.EXE a                     Line 4:    Name of the compression utility to
  150.                                          use, including any pre-filename
  151.                                          switches.  Put the word "NONE" here
  152.                                          if you do not want this option.
  153.  
  154.                               NOTE: Refer to your compression utility's DOCs
  155.                               for additional info regarding the use of
  156.                               command line switches.
  157.  
  158. -d -y                         Line 5:    Post-filename switches, if any, that
  159.                                          are supported by the compression
  160.                                          utility.
  161.  
  162.                               NOTE: Refer to your compression utility's DOCs
  163.                               for additional info regarding the use of
  164.                               command line switches.
  165.  
  166. ▓                             Line 6:     This is the filler character for
  167.                                           WLIST to use when making the file
  168.                                           area header.  A "+" character would
  169.                                           cause the Area Name to be displayed
  170.                                           as:
  171.                                           ++++++++++++++++ Games ++++++++++++++
  172.  
  173.                                           Any keyboard character should work
  174.                                           fine here.
  175.  
  176. Include 1 3 31-32 45          Line 7:     Areas to include in the filelist.
  177.                                           You may use either the "Include" or
  178.                                           "Exclude" command, but not both.
  179.  
  180.                               Example: "Include 1-21 25 28 30-49" would
  181.                               include all file areas from 1 thru 21, plus
  182.                               area 25, area 28, and areas 30 thru 49.  Only
  183.                               these areas would be included in the filelist.
  184.  
  185.                               "Exclude 1-21 25 28 30-49" would include all
  186.                               areas EXCEPT areas 1 thru 21, area 25, area
  187.                               28, and areas 30 thru 49.  All other areas
  188.                               would be included in the filelist.
  189.  
  190.                               Either blank spaces or commas may be used to
  191.                               delimit areas, i.e. "21 24 30" is the same as
  192.                               "21,24,30" and means areas 21, 24, and 30.
  193.  
  194.                               Delimeters can be used in combination, i.e.
  195.                               1-10 13 15 18,20 27-40
  196.  
  197. D                             Line 8:     Determine how detailed the output
  198.                                           should be, where "S" is Single Line,
  199.                                           and "D" is Double Line.
  200.  
  201.  
  202.  Example of the Single Line Output:
  203.  
  204.  0154PICP.GIF  148k  1w blonde laying on raft
  205.  0159PICR.GIF  151k  1w woman in lacy blue outfit
  206.  0160PICP.GIF   97k  1w black lacy outfit
  207.  0293PICP.GIF  116k  1w in white outfit
  208.  0378PICG.GIF  196k  1w blonde posing on beach
  209.  1BIKINI.GIF   245k  1w brunette in shiny suit
  210.  2SNAP.GIF     139k  1w in green outfit with motorcycle
  211.  370PIC.GIF    162k  1w laying on lounge chair
  212.  
  213.  
  214.  Example Of Double Line :
  215.  
  216.  ABY5_40.ZIP   188,012   07/26/88 | Free-form database. Like 3x5 cards. v4.0
  217.  DwnLds: 0     LastDL:   01/01/00 |
  218.  
  219.  A2Z10.ZIP     245,901   11/22/88 | Flat-file DBMS.
  220.  DwnLds: 0     LastDL:   01/01/00 |
  221.  
  222.  ABC_FILE.ZIP   97,780   08/04/87 | A file manager. Easy as ABC.
  223.  DwnLds: 0     LastDL:   01/01/00 |
  224.  
  225.  ADDRESB.ZIP    28,238   04/21/88 | Address book in dBase III
  226.  DwnLds: 0     LastDL:   01/01/00 |
  227.  
  228.  ADDRESS.ZIP    21,730   08/04/87 | Nice address/phone manager. BASIC source
  229.  DwnLds: 0     LastDL:   01/01/00 |
  230.  
  231.  ADDRESS2.ZIP   65,211   12/08/88 | Personal address manager.
  232.  DwnLds: 0     LastDL:   01/01/00 |
  233.  
  234.  
  235.  
  236. Y                             Line 9:     Freshen the File Size/Date in the
  237.                                           Wildcat! file database?  For further
  238.                                           discussion regarding the Freshen
  239.                                           option, see Line 3 above.
  240.  
  241. N                             Line 10:    Check for the optional ###.HDR Area
  242.                                           Header Files?
  243.  
  244.                               If 1.HDR exist and this option is turned on
  245.                               then your Area Header Name will be replaced by
  246.                               the Contents of the 1.HDR file. One .HDR file
  247.                               per Area is allowed.
  248.  
  249. N                             Line 11:    Include File Size and total number
  250.                                           of area files at the bottom of each
  251.                                           Area, and Grand Total of files and
  252.                                           Total Bytes at the bottom of the
  253.                                           filelist?
  254.  
  255. N                             Line 12:    Include a list of the Top Ten
  256.                                           Downloads for each Area?
  257.  
  258. N                             Line 13:    Include the ASCII file AD.HDR at the
  259.                                           beginning of the filelist if it
  260.                                           exists?
  261.  
  262.                               This option, if used (Y) also includes a file
  263.                               called END.HDR at the end of the filelist.  If
  264.                               creating bulletins, all the files will be .BUL
  265.                               instead of .HDR , This permits the use of
  266.                               @Codes@ in the bulletins but not in the
  267.                               downloadable filelist.
  268.  
  269. N 1                           Line 14:    Append results to the Wildcat!
  270.                                           Activity Log?
  271.  
  272.                               If "Y," then the log number (Node) is required.
  273.                               Example: Y 1 will append to ACTIVITY.001
  274.  
  275. N                             Line 15:    Delete the original output file?
  276.                                           See discussion at Line 2 above.
  277.  
  278.                               This option works only if Line 4 is set to
  279.                               something besides None.
  280.  
  281. N                             Line 16:    Include Password/Offline Files?  If
  282.                                           "Y," P will replace "|" character
  283.                                           (for  Password files) or O (for
  284.                                           Offline files), exactly like the
  285.                                           screen output when a caller is doing
  286.                                           a (L)ist Files in WildCat!
  287.  
  288. Y                             Line 17:    Allow Failed Scan Files to be shown
  289.                                           in the output file.
  290.  
  291. Y                             Line 18:    Insert the Abbreviation Index
  292.                                           at the beginning of the file list.
  293.                                           Look at the WhatsNew.150 file
  294.                                           for more info.
  295.  
  296. List                          Line 19:    Accepts : BULL  LIST  BOTH
  297.  
  298.                               BULL - will create a bulletin Only with the
  299.                               @color@ codes Only.
  300.  
  301.                               useage > BULL  Bul1.cfg Bull.cfg is the name
  302.                               of your config file that contains all the
  303.                               @COLOR@ stuff you want to use for that
  304.                               bulletin.
  305.  
  306.                               See the sample Bul1.cfg file.
  307.  
  308.                               LIST - Creates a normal File List - No
  309.                               Parameters - No Color
  310.  
  311.                               usage > LIST
  312.  
  313.                               BOTH - Creates a bulletin and a Normal File
  314.                               List.  Uses the same Parameters as BULL
  315.  
  316.                               useage > BOTH Bul1.cfg
  317.  
  318. Y                             Line 20:    Do you wish to insert your own
  319.                                           description ?
  320.  
  321.                               Example -  You wish people to see your adult
  322.                               file list before they get access... You can
  323.                               enter a default file description for the
  324.                               public to see instead of the regular
  325.                               description.
  326.  
  327.                               For your normal adult list, you would ofcourse
  328.                               want the real Descriptions.  If your not sure
  329.                               of this option, you can contact me or leave it
  330.                               alone, or maybe even experiment with it.
  331.  
  332. Description Omitted           Line 21:    This would be the alternate file
  333.                                           description.
  334.  
  335. 31-35                         Line 22:    These are the areas that will get
  336.                                           the Alternate file descriptions.
  337.  
  338.                               usage : 31 32 34-38  or 31,32,34-38  All files
  339.                               in these areas will have the description from
  340.                               line 19 inserted, the rest of the areas would
  341.                               have the regular database description.
  342.  
  343.  
  344.  
  345. WildList will Ignore everything past the 22th line, so comments are Ok!
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352. Support & Keys
  353. ~~~~~~~~~~~~~~
  354.  
  355.              Support by Netmail or BBS to the Author is available @
  356.  
  357.                               Fido  1:117/112
  358.                             The Mechanic Shop I
  359.                                (409) 846-0754
  360.                               Richard  Skinner
  361.                                USR HST  14.4
  362.  
  363.                                     Or
  364.  
  365.                               Fido  1:117/132
  366.                             The Mechanic Shop II
  367.                                (409) 260-1883
  368.                               Richard  Skinner
  369.                                V32.b    14.4
  370.  
  371.  
  372. Other Support & Keys
  373. ~~~~~~~~~~~~~~~~~~~~
  374.  
  375.                    Other Support Sites are listed below.
  376.                    You may obtain the latest version and
  377.                    a current Demo key from these sites.
  378.  
  379.                    A Current WildList Key will be made
  380.                    available as 'WILDLIST.KEY' and will
  381.                    not be made Freq'able.
  382.  
  383.  
  384.                               Fido 1:117/120
  385.                                 Jim Vargas
  386.                                USR HST 14.4
  387.  
  388.                               Fido  1:281/2
  389.                                 Mike Ortiz
  390.                                USR DS  16.8
  391.  
  392.  
  393.  
  394. Registration
  395. ~~~~~~~~~~~~
  396.  
  397.  Fill Out the Register.Frm file with all the info and include it along
  398.  with a Check or Money Order in the amount of $15 US dollars to :
  399.  
  400.                              Richard Skinner
  401.                              802-A Eagle Pass
  402.                              Bryan,Tx  77802
  403.  
  404.                                 << OR >>
  405.  
  406.           For even faster registration, use your credit card !
  407.                             MasterCard / Visa
  408.  
  409.                          BBS Online Registration
  410.                          (409) 260-1883  V32bis
  411.                          (409) 846-0754  HST
  412.  
  413.  Have you WildCat! Registration Number, Card Number, Exp Date, BBS Name
  414.  Available. Select [R] eg. Wildlist at the main Menu.
  415.  
  416.  
  417.  
  418. Disclaimer
  419. ~~~~~~~~~~
  420.   While we have taken every care to provide a working, stable program, we
  421.   cannot be responsible for any damages that may arise because of the use
  422.   of this program.  You use it at your own risk, plain and simple.
  423.  
  424.  
  425.  
  426.  
  427.  Thanks to Jim Vargas for the Docs !
  428.  
  429.  Thanks for Supporting Shareware!
  430.  Richard Skinner - TMS Computers
  431.  
  432.  
  433.